<!DOCTYPE html>
<html lang="zh" dir="ltr">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>pyChariot.api.device | pyChariot</title>
    <meta name="description" content="pyChariot, 跨平台桌面应用开发工具。">
    <meta name="generator" content="VitePress v1.6.3">
    <link rel="preload stylesheet" href="/pyChariot/assets/style.C7gINder.css" as="style">
    <link rel="preload stylesheet" href="/pyChariot/vp-icons.css" as="style">
    
    <script type="module" src="/pyChariot/assets/app.yb7VBtcs.js"></script>
    <link rel="preload" href="/pyChariot/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/framework.6RT3NpRm.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/theme.BPEWUb8z.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/katex.CfZphoad.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/dagre-4EVJKHTY.BVpvYX2y.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/c4Diagram-6F5ED5ID.idSOoxa_.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/flowDiagram-7ASYPVHJ.CA1ZYu2c.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/erDiagram-6RL3IURR.DgrQUcUj.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/gitGraphDiagram-NRZ2UAAF.CeJLuZdZ.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/ganttDiagram-NTVNEXSI.JsAUejA1.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/infoDiagram-A4XQUW5V.DMgh5ndY.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/pieDiagram-YF2LJOPJ.aN2I7JER.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/quadrantDiagram-OS5C2QUG.Ddqp8KtS.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/xychartDiagram-6QU3TZC5.DupQK489.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/requirementDiagram-MIRIMTAZ.9ePka975.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/sequenceDiagram-G6AWOVSC.BXpqU6rj.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/classDiagram-LNE6IOMH.D2h9DvPZ.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/classDiagram-v2-MQ7JQ4JX.D2h9DvPZ.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/stateDiagram-MAYHULR4.j-M5A2SE.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/stateDiagram-v2-4JROLMXI.BIRFOvrz.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/journeyDiagram-G5WM74LC.BHfjuK9l.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/timeline-definition-U7ZMHBDA.YCR9CJ2W.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/mindmap-definition-GWI6TPTV.IS6ocwCZ.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/kanban-definition-QRCXZQQD.BG14Lg8e.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/sankeyDiagram-Y46BX6SQ.DSioXVnP.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/diagram-QW4FP2JN.Cfi6NI3q.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/blockDiagram-ZHA2E4KO.BxZy3JpU.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/architectureDiagram-UYN6MBPD.BKQiQUw_.js">
    <link rel="modulepreload" href="/pyChariot/assets/chunks/virtual_mermaid-config.DDnGl6nM.js">
    <link rel="modulepreload" href="/pyChariot/assets/jsapi_device.md.DbRW_pEV.lean.js">
    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
  </head>
  <body>
    <div id="app"><div class="Layout" data-v-d8b57b2d><!--[--><!--]--><!--[--><span tabindex="-1" data-v-fcbfc0e0></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-fcbfc0e0>跳转到内容</a><!--]--><!----><header class="VPNav" data-v-d8b57b2d data-v-7ad780c2><div class="VPNavBar" data-v-7ad780c2 data-v-9fd4d1dd><div class="wrapper" data-v-9fd4d1dd><div class="container" data-v-9fd4d1dd><div class="title" data-v-9fd4d1dd><div class="VPNavBarTitle has-sidebar" data-v-9fd4d1dd data-v-9f43907a><a class="title" href="/pyChariot/" data-v-9f43907a><!--[--><!--]--><!----><span data-v-9f43907a>pyChariot</span><!--[--><!--]--></a></div></div><div class="content" data-v-9fd4d1dd><div class="content-body" data-v-9fd4d1dd><!--[--><!--]--><div class="VPNavBarSearch search" data-v-9fd4d1dd><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-9fd4d1dd data-v-afb2845e><span id="main-nav-aria-label" class="visually-hidden" data-v-afb2845e> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/pyChariot/" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>回首页</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/pyChariot/changelog.html" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>更新日志</span><!--]--></a><!--]--><!--[--><a class="VPLink link vp-external-link-icon VPNavBarMenuLink" href="https://github.com/Chanix/pyChariot/releases" target="_blank" rel="noreferrer" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>立即下载</span><!--]--></a><!--]--><!--[--><a class="VPLink link vp-external-link-icon VPNavBarMenuLink" href="https://github.com/Chanix/pyChariot/discussions" target="_blank" rel="noreferrer" tabindex="0" data-v-afb2845e data-v-815115f5><!--[--><span data-v-815115f5>讨论组</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-9fd4d1dd data-v-3f90c1a5><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-3f90c1a5 data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-9fd4d1dd data-v-ef6192dc data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://Chanix.github.io/" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-9fd4d1dd data-v-f953d92f data-v-bfe7971f><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-bfe7971f><span class="vpi-more-horizontal icon" data-v-bfe7971f></span></button><div class="menu" data-v-bfe7971f><div class="VPMenu" data-v-bfe7971f data-v-20ed86d6><!----><!--[--><!--[--><!----><div class="group" data-v-f953d92f><div class="item appearance" data-v-f953d92f><p class="label" data-v-f953d92f>主题</p><div class="appearance-action" data-v-f953d92f><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-f953d92f data-v-be9742d9 data-v-b4ccac88><span class="check" data-v-b4ccac88><span class="icon" data-v-b4ccac88><!--[--><span class="vpi-sun sun" data-v-be9742d9></span><span class="vpi-moon moon" data-v-be9742d9></span><!--]--></span></span></button></div></div></div><div class="group" data-v-f953d92f><div class="item social-links" data-v-f953d92f><div class="VPSocialLinks social-links-list" data-v-f953d92f data-v-e71e869c><!--[--><a class="VPSocialLink no-icon" href="https://Chanix.github.io/" aria-label="github" target="_blank" rel="noopener" data-v-e71e869c data-v-60a9a2d3><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-9fd4d1dd data-v-6bee1efd><span class="container" data-v-6bee1efd><span class="top" data-v-6bee1efd></span><span class="middle" data-v-6bee1efd></span><span class="bottom" data-v-6bee1efd></span></span></button></div></div></div></div><div class="divider" data-v-9fd4d1dd><div class="divider-line" data-v-9fd4d1dd></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-d8b57b2d data-v-2488c25a><div class="container" data-v-2488c25a><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-2488c25a><span class="vpi-align-left menu-icon" data-v-2488c25a></span><span class="menu-text" data-v-2488c25a>菜单</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-2488c25a data-v-6b867909><button data-v-6b867909>回到顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-d8b57b2d data-v-42c4c606><div class="curtain" data-v-42c4c606></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-42c4c606><span class="visually-hidden" id="sidebar-aria-label" data-v-42c4c606> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>pyChariot 简介</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/what-is-pychariot.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>pyChariot 是什么</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/getting-started.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>快速开始</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>开发示例</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/examples-deepseek.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>示例：DeepSeek</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>开发者指南</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/args.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>命令行参数</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/dirs-and-files.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>文件与目录结构</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-1" data-v-0009425e data-v-0009425e><!----><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/dir-appchips.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>appchips</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/dir-data.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>data</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/dir-temp.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>temp</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/dir-wvdata.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>wvdata</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><div class="no-transition group" data-v-51288d80><section class="VPSidebarItem level-0 collapsible has-active" data-v-51288d80 data-v-0009425e><div class="item" role="button" tabindex="0" data-v-0009425e><div class="indicator" data-v-0009425e></div><h2 class="text" data-v-0009425e>JS 扩展与 API</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-0009425e><span class="vpi-chevron-right caret-icon" data-v-0009425e></span></div></div><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>扩展对象概述</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-1 has-active" data-v-0009425e data-v-0009425e><!----><div class="items" data-v-0009425e><!--[--><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_appchip.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>小应用　　　appchip</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_clipboard.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>剪贴板　　　clipboard</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_core.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>基础功能　　core</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_device.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>设备信息　　device</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_dialog.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>对话框　　　dialog</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_env.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>环境变量　　env</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_fsys.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>文件系统　　fsys</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_hotkey.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>全局热键　　hotkey</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_mainwin.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>主窗口　　　mainwin</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_memdb.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>内存数据库　memdb</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_process.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>进程管理　　process</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-0009425e data-v-0009425e><div class="item" data-v-0009425e><div class="indicator" data-v-0009425e></div><a class="VPLink link link" href="/pyChariot/jsapi_python.html" data-v-0009425e><!--[--><p class="text" data-v-0009425e>python&nbsp;&nbsp;　　python</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-d8b57b2d data-v-9a6c75ad><div class="VPDoc has-sidebar has-aside" data-v-9a6c75ad data-v-e6f2a212><!--[--><!--]--><div class="container" data-v-e6f2a212><div class="aside" data-v-e6f2a212><div class="aside-curtain" data-v-e6f2a212></div><div class="aside-container" data-v-e6f2a212><div class="aside-content" data-v-e6f2a212><div class="VPDocAside" data-v-e6f2a212 data-v-cb998dce><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-cb998dce data-v-f610f197><div class="content" data-v-f610f197><div class="outline-marker" data-v-f610f197></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-f610f197>本页导航</div><ul class="VPDocOutlineItem root" data-v-f610f197 data-v-53c99d69><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-cb998dce></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-e6f2a212><div class="content-container" data-v-e6f2a212><!--[--><!--]--><main class="main" data-v-e6f2a212><div style="position:relative;" class="vp-doc _pyChariot_jsapi_device" data-v-e6f2a212><div><h1 id="pychariot-api-device" tabindex="-1">pyChariot.api.device <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#pychariot-api-device" aria-label="Permalink to &quot;pyChariot.api.device &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt;&quot;">​</a></h1><p>设备信息，当前运行设备的相关信息</p><h2 id="isPOSIX" tabindex="-1">isPOSIX() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isPOSIX" aria-label="Permalink to &quot;isPOSIX() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isPOSIX}&quot;">​</a></h2><p>操作系统是否 POSIX</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isPOSIX</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isLinux" tabindex="-1">isLinux() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isLinux" aria-label="Permalink to &quot;isLinux() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isLinux}&quot;">​</a></h2><p>操作系统是否 Linux</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isLinux</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isWindows" tabindex="-1">isWindows() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isWindows" aria-label="Permalink to &quot;isWindows() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isWindows}&quot;">​</a></h2><p>操作系统是否 Windows</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isWindows</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isMacOS" tabindex="-1">isMacOS() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isMacOS" aria-label="Permalink to &quot;isMacOS() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isMacOS}&quot;">​</a></h2><p>操作系统是否 MacOS</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isMacOS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isFreeBSD" tabindex="-1">isFreeBSD() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isFreeBSD" aria-label="Permalink to &quot;isFreeBSD() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isFreeBSD}&quot;">​</a></h2><p>操作系统是否 FreeBSD</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isFreeBSD</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isNetBSD" tabindex="-1">isNetBSD() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isNetBSD" aria-label="Permalink to &quot;isNetBSD() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isNetBSD}&quot;">​</a></h2><p>操作系统是否 NetBSD</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isNetBSD</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isOpenBSD" tabindex="-1">isOpenBSD() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isOpenBSD" aria-label="Permalink to &quot;isOpenBSD() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isOpenBSD}&quot;">​</a></h2><p>操作系统是否 OpenBSD</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isOpenBSD</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isBSD" tabindex="-1">isBSD() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isBSD" aria-label="Permalink to &quot;isBSD() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isBSD}&quot;">​</a></h2><p>操作系统是否 BSD</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isBSD</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isSunOS" tabindex="-1">isSunOS() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isSunOS" aria-label="Permalink to &quot;isSunOS() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isSunOS}&quot;">​</a></h2><p>操作系统是否 SunOS</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isSunOS</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="isAIX" tabindex="-1">isAIX() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#isAIX" aria-label="Permalink to &quot;isAIX() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#isAIX}&quot;">​</a></h2><p>操作系统是否 AIX</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">boolean</td><td style="text-align:left;"></td></tr></tbody></table><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">isAIX</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getCPUCount" tabindex="-1">getCPUCount(logical) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUCount" aria-label="Permalink to &quot;getCPUCount(logical) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUCount}&quot;">​</a></h2><p>获取 CPU 数量</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">logic</td><td style="text-align:left;">boolean</td><td style="text-align:left;">逻辑处理器，可忽略，默认为 true</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">int</td><td style="text-align:left;">CPU 数量</td></tr></tbody></table><p>如果 logical 为 false，仅返回物理内核的数量。如果 logical 为 true，返回逻辑内核的数量。 在 OpenBSD 和 NetBSD 上总是返回 null。 请注意， 可能不一定等于当前进程可以使用的实际 CPU 数量。 如果进程 CPU 亲和性已更改、正在使用 Linux cgroups 或（在 Windows 的情况下）在使用处理器组或具有超过 64 个 CPU 的系统上，这可能会有所不同。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUCount</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUCount</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">false</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getCPUTimes" tabindex="-1">getCPUTimes(percpu) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUTimes" aria-label="Permalink to &quot;getCPUTimes(percpu) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUTimes}&quot;">​</a></h2><p>获取 CPU 时间信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">percpu</td><td style="text-align:left;">boolean</td><td style="text-align:left;">详细列出每个内核，可忽略，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object 或 list[object]</td><td style="text-align:left;">CPU 时间信息</td></tr></tbody></table><p>列出CPU时间信息，其中每个属性代表 CPU 在给定模式下花费的秒数。属性可用性因平台而异。</p><ul><li>user: 进程在用户模式(user mode)下执行所花费的时间； 在 Linux 上，这也包括访客时间(guest time)；</li><li>system: 进程在内核模式(kernel mode)下执行所花费的时间；</li><li>idle: 空闲时间；</li></ul><p>特定平台的字段:</p><ul><li>nice (UNIX): niced(优先) 进程在用户模式(user mode)下所花费的时间; 在 Linux 上，这也包括访客优先时间(guest_nice time)；</li><li>iowait (Linux): 等待 I/O 完成所花费的时间。 这不计入空闲时间中；</li><li>irq (Linux, BSD): 服务硬件中断所花费的时间；</li><li>softirq (Linux): 服务软件中断所花费的时间；</li><li>steal (Linux 2.6.11+): 在虚拟化环境中运行的其他操作系统所花费的时间；</li><li>guest (Linux 2.6.24+): 在 Linux 内核的控制下为客户操作系统运行虚拟 CPU 所花费的时间；</li><li>guest_nice (Linux 3.2.0+): niced(优先) 访客进程所花费的时间 (用于在 Linux 内核控制下的客户操作系统的虚拟 CPU)；</li><li>interrupt (Windows): 服务硬件中断所花费的时间 ( 类似于 UNIX 上的 “irq”)；</li><li>dpc (Windows): 服务延迟过程调用服务中断 (DPC) 所花费的时间； DPC 是运行优先级低于标准中断(interrupts)的中断；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUTimes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUTimes</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getCPUStats" tabindex="-1">getCPUStats() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUStats" aria-label="Permalink to &quot;getCPUStats() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUStats}&quot;">​</a></h2><p>获取 CPU 统计信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">array[number]</td><td style="text-align:left;">CPU 统计信息</td></tr></tbody></table><p>CPU 统计信息：</p><ul><li>ctx_switches: 自启动以来的上下文切换次数（自愿 + 非自愿）；</li><li>interrupts: 自启动以来的中断数；</li><li>soft_interrupts: 自启动以来的软件中断数。 在 Windows 和 SunOS 上始终为 0；</li><li>syscalls: 自启动以来的系统调用数。 在 Linux 上始终为 0；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUStats</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getCPUPercent" tabindex="-1">getCPUPercent(percpu) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUPercent" aria-label="Permalink to &quot;getCPUPercent(percpu) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUPercent}&quot;">​</a></h2><p>获取 CPU 利用率</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">percpu</td><td style="text-align:left;">boolean</td><td style="text-align:left;">详细列出每个内核，可忽略，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">number 或 list[number]</td><td style="text-align:left;">CPU 利用率信息</td></tr></tbody></table><p>如果 percpu 忽略或为 false，返回一个浮点数，以百分比形式表示当前系统范围内的 CPU 利用率。 如果 percpu 为 true，返回一个浮点数的 list，其中的元素为每个 CPU 的利用率信息。</p><p><em><strong>第一次调用它时，会返回一个您应该忽略的无意义的 0.0 值。为了准确起见，建议在两次调用之间至少间隔 0.1 秒来调用此函数。</strong></em></p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUPercent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUPercent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getCPUTimesPercent" tabindex="-1">getCPUTimesPercent(percpu) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUTimesPercent" aria-label="Permalink to &quot;getCPUTimesPercent(percpu) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUTimesPercent}&quot;">​</a></h2><p>获取 CPU 时间利用率百分比</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">percpu</td><td style="text-align:left;">boolean</td><td style="text-align:left;">详细列出每个内核，可忽略，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object 或 list[object]</td><td style="text-align:left;">CPU 利用率信息</td></tr></tbody></table><p>如果 percpu 忽略或为 false，返回对象，以百分比形式表示当前系统范围内的 CPU 时间利用率。 如果 percpu 为 true，返回一个浮点数的 list，其中的元素为每个 CPU 的时间利用率信息。</p><p>在 Linux 上，“guest”和“guest_nice”百分比不计入“user”和“user_nice”百分比。</p><p><em><strong>第一次调用它时，会返回一个您应该忽略的无意义的 0.0 值。为了准确起见，建议在两次调用之间至少间隔 0.1 秒来调用此函数。</strong></em></p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUTimesPercent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUTimesPercent</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getCPUFfreq" tabindex="-1">getCPUFfreq(percpu) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getCPUFfreq" aria-label="Permalink to &quot;getCPUFfreq(percpu) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getCPUFfreq}&quot;">​</a></h2><p>获取 CPU 频率</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">percpu</td><td style="text-align:left;">boolean</td><td style="text-align:left;">详细列出每个内核，可忽略，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object 或 list[object]</td><td style="text-align:left;">CPU 频率信息</td></tr></tbody></table><p>如果 percpu 忽略或为 false，返回对象，以百分比形式表示当前系统范围内的 CPU 频率。 如果 percpu 为 true，返回一个浮点数的 list，其中的元素为每个 CPU 的频率。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUFfreq</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getCPUFfreq</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getLoadAvg" tabindex="-1">getLoadAvg() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getLoadAvg" aria-label="Permalink to &quot;getLoadAvg() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getLoadAvg}&quot;">​</a></h2><p>获取系统平均负载。</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">array</td><td style="text-align:left;">包括3个元素，分别为 过去 1、5 和 15 分钟的平均系统负载</td></tr></tbody></table><p>“负载”表示处于可运行状态的进程，要么使用 CPU，要么等待使用 CPU（例如，等待磁盘 I/O）。</p><ul><li>Unix 中，和 <code>update</code> 命令的意义相同；</li><li>在 Windows 上是通过 Windows API 模拟的，因此第一次调用它，在接下来的 5 秒内，将返回一个无意义的 (0.0, 0.0, 0.0)；</li></ul><p>返回的数字仅在与系统上安装的 CPU 内核数相关时才有意义。例如，具有 10 个逻辑 CPU 的系统上的值 3.14 意味着系统负载在过去 N 分钟内为 31.4%。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getLoadAvg</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getVirtualMemory" tabindex="-1">getVirtualMemory() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getVirtualMemory" aria-label="Permalink to &quot;getVirtualMemory() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getVirtualMemory}&quot;">​</a></h2><p>获取系统内存使用状况。</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;">内存使用信息</td></tr></tbody></table><p>对象中的信息属性如下：</p><ul><li>total: 总物理内存（独占交换）；</li><li>available: 可以立即分配给进程而无需系统进行交换的内存。这是通过根据平台对不同的内存值求和来计算的，它应该用于以跨平台方式监控实际内存使用情况；</li></ul><p>其他数据:</p><ul><li>used: 使用的内存，计算方式因平台而异，仅供参考。 total - free 不一定匹配 used；</li><li>free: 根本没有使用（归零）的随时可用的内存； 请注意，这并不反映实际可用内存（请改用可用(available)内存）。 total - used 不一定匹配 free；</li><li>active (UNIX): 当前正在使用或最近使用的内存，因此它在 RAM 中；</li><li>inactive (UNIX): 标记为未使用的内存；</li><li>buffers (Linux, BSD): 缓存文件系统元数据等内容；</li><li>cached (Linux, BSD): 缓存各种东西；</li><li>shared (Linux, BSD): 可以被多个进程同时访问的内存；</li><li>slab (Linux): 内核数据结构缓存；</li><li>wired (BSD, macOS): 标记为始终保留在 RAM 中的内存。 它永远不会移动到磁盘；</li></ul><p>已用 (used) 和可用 (available) 的总和不一定等于总数 (total)。 在 Windows 上可用 (available) 和空闲 (free) 是一样的。</p><p>如果您只想知道跨平台方式还剩下多少物理内存，只需依赖可用 (available) 字段即可。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getVirtualMemory</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">console.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">log</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;当前可用内存：&#39;</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;"> +</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> (</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getVirtualMemory</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">()).available)</span></span></code></pre></div><h2 id="getSwapMemory" tabindex="-1">getSwapMemory() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getSwapMemory" aria-label="Permalink to &quot;getSwapMemory() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getSwapMemory}&quot;">​</a></h2><p>获取系统交换内存使用状况。</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;">内存使用信息</td></tr></tbody></table><p>系统交换内存统计信息，包括以下字段：</p><ul><li>total: 以字节为单位的总交换内存；</li><li>used: 使用的交换内存（以字节为单位）；</li><li>free: 以字节为单位的空闲交换内存；</li><li>percent: 百分比使用率计算为 (total - available) / total * 100；</li><li>sin: 系统从磁盘换入的字节数（累计）；</li><li>sout: 系统从磁盘换出的字节数（累计）；</li></ul><p>操作系统差异性：</p><ul><li>Windows 上的 sin 和 sout 始终设置为 0；</li><li>Linux 上，依赖 /proc fs 而不是 sysinfo() 系统调用；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getSwapMemory</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getDiskPartitions" tabindex="-1">getDiskPartitions(all) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getDiskPartitions" aria-label="Permalink to &quot;getDiskPartitions(all) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getDiskPartitions}&quot;">​</a></h2><p>获取设备挂在的磁盘分区信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">all</td><td style="text-align:left;">boolean</td><td style="text-align:left;">是否列出所有磁盘信息，可忽略，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;">列表，每个元素为一个磁盘分区的信息</td></tr></tbody></table><p>获取设备挂在的磁盘分区信息，包括设备、挂载点和文件系统类型，类似于 UNIX 上的“df”命令。 如果 all 参数为 False，它会尝试仅区分和返回物理设备（例如硬盘、CD-ROM 驱动器、USB 密钥）并忽略所有其他设备（例如伪(pseudo) 、内存、重复、无法访问的文件系统）。</p><p>请注意，all 参数并非在所有系统上都完全可靠（例如，在 BSD 上，此参数被忽略）。</p><p>列表中的每个元素说明一个磁盘分区的详细信息，包括以下属性：</p><ul><li>device: 设备路径（例如“/dev/hda1”）。在 Windows 上，这是驱动器号（例如“C:\”）。</li><li>mountpoint: 挂载点路径（例如“/”）。在 Windows 上，这是驱动器号（例如“C:\”）。</li><li>fstype: 分区文件系统（例如 UNIX 上的“ext3”或 Windows 上的“NTFS”）。</li><li>opts: 一个逗号分隔的字符串，指示驱动器/分区的不同挂载选项。平台相关。</li><li>maxfile: 文件名可以具有的最大长度。平台相关。</li><li>maxpath: 路径名（目录名 + 基本文件名）的最大长度。平台相关。</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskPartitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskPartitions</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">true</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getDiskUsage" tabindex="-1">getDiskUsage(path) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getDiskUsage" aria-label="Permalink to &quot;getDiskUsage(path) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getDiskUsage}&quot;">​</a></h2><p>获取指定路径的磁盘使用统计信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">path</td><td style="text-align:left;">string</td><td style="text-align:left;">路径，可忽略，默认为 PYCHARIOT_HOME</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;">使用统计信息</td></tr></tbody></table><p>使用统计信息包括以下属性：</p><ul><li>total: 以字节表示的总空间；</li><li>used: 以字节表示的已用空间</li><li>free: 以字节表示的可用空间；</li><li>percent: 使用百分比；</li></ul><p><em>这些值和 “df” 命令行程序是一致的。</em></p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskUsage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskUsage</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;C:</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&#39;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">);</span></span></code></pre></div><h2 id="getDiskIOCounters" tabindex="-1">getDiskIOCounters(perdisk, nowrap) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getDiskIOCounters" aria-label="Permalink to &quot;getDiskIOCounters(perdisk, nowrap) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getDiskIOCounters}&quot;">​</a></h2><p>获取磁盘 IO 统计信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">perdisk</td><td style="text-align:left;">boolean</td><td style="text-align:left;">默认为 false</td></tr><tr><td style="text-align:left;">nowrap</td><td style="text-align:left;">boolean</td><td style="text-align:left;">默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;">磁盘 IO 统计信息</td></tr></tbody></table><p>返回系统范围的磁盘 I/O 统计信息，包括以下属性：</p><ul><li>read_count: 读取次数</li><li>write_count: 写入次数</li><li>read_bytes: 读取的字节数</li><li>write_bytes: 写入的字节数</li></ul><p>特定于平台的属性:</p><ul><li>read_time(除了 NetBSD 和 OpenBSD): 从磁盘读取所花费的时间（以毫秒为单位）</li><li>write_time(除了 NetBSD 和 OpenBSD): 写入磁盘所花费的时间（以毫秒为单位）</li><li>busy_time(Linux, FreeBSD): 花费在实际 I/O 上的时间（以毫秒为单位）</li><li>read_merged_count (Linux): 合并读取的数量（参见 iostats 文档）</li><li>write_merged_count (Linux): 合并写入的数量（请参阅 iostats 文档）</li></ul><p>如果 perdisk 为 True ，则返回系统上安装的每个物理磁盘的相同信息，分区名称作为键。</p><p>在某些系统（例如Linux）上，在非常繁忙或寿命很长的系统上，内核返回的数字可能会溢出并换行（从零开始）。</p><p>如果 nowrap 为 True，函数调用中检测并调整这些数字，并将“旧值”添加到“新值”，以便返回的数字始终增加或保持不变，但永远不会减少。 disk_io_counters.cache_clear() 可用于使 nowrap 缓存无效。 在 Windows 上，可能需要首先从 cmd.exe 发出 diskperf -y 命令以启用 IO 计数器。 在无盘机器上，如果 perdisk 为 True，此函数将返回 null 或 {}。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskIOCounters</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getNetIOCounters" tabindex="-1">getNetIOCounters(pernic, nowrap) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getNetIOCounters" aria-label="Permalink to &quot;getNetIOCounters(pernic, nowrap) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getNetIOCounters}&quot;">​</a></h2><p>获取网络 IO 统计信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">pernic</td><td style="text-align:left;">boolean</td><td style="text-align:left;">默认为 false</td></tr><tr><td style="text-align:left;">nowrap</td><td style="text-align:left;">boolean</td><td style="text-align:left;">默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;">网络 IO 统计信息</td></tr></tbody></table><p>返回系统范围的网络 I/O 统计信息，包括以下属性：</p><ul><li>bytes_sent: 发送的字节数</li><li>bytes_recv: 接收的字节数</li><li>packets_sent: 发送的数据包数</li><li>packets_recv: 收到的数据包数</li><li>errin: 接收时的错误总数</li><li>errout: 发送时的错误总数</li><li>dropin: 丢弃的传入数据包总数</li><li>dropout: 丢弃的传出数据包总数（在 macOS 和 BSD 上始终为 0）</li></ul><p>如果 pernic 为 True，则返回系统上安装的每个网络接口的相同信息，其中网络接口名称作为键。</p><p>在某些系统（例如 Linux）上，在非常繁忙或寿命很长的系统上，内核返回的数字可能会溢出并换行（从 0 开始）。</p><p>如果 nowrap 为 True ，将在函数调用中检测并调整这些数字，并将“旧值”添加到“新值”，以便返回的数字始终增加或保持不变，但永远不会减少。 net_io_counters.cache_clear() 可用于使 nowrap 缓存无效。 在没有网络接口的机器上，如果 pernic 为 True ，此函数将返回 null 或 {}。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getDiskIOCounters</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getNetConnections" tabindex="-1">getNetConnections(kind) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getNetConnections" aria-label="Permalink to &quot;getNetConnections(kind) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getNetConnections}&quot;">​</a></h2><p>获取系统网络连接信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">kind</td><td style="text-align:left;">string</td><td style="text-align:left;">网卡设备类型，默认为 inet （以太网）</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;">网络连接信息</td></tr></tbody></table><p>返回系统网络连接信息列表，每个元素具体说明一个连接的信息，包含的属性视操作系统有差异。 Windows 下包括以下属性：</p><ul><li>family: 地址族；</li><li>laddr: 本地地址；</li><li>raddr: 远程地址；</li><li>status: 连接的状态</li><li>pid: 相关 pid</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getNetConnections</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getNetIFAddrs" tabindex="-1">getNetIFAddrs() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getNetIFAddrs" aria-label="Permalink to &quot;getNetIFAddrs() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getNetIFAddrs}&quot;">​</a></h2><p>获取系统网络接口信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;">网络接口列表</td></tr></tbody></table><p>返回系统网络接口信息列表，元素为网络接口信息，包括以下属性：</p><ul><li>family: 地址族；</li><li>address: 主 NIC 地址（始终设置）；</li><li>netmask: 网络掩码地址（可能是 null ）；</li><li>broadcast: 广播地址（可能是 null ）；</li><li>ptp: 代表“点对点”(point to point)； 它是点对点接口（通常是 VPN）上的目标地址。 广播和 ptp 是互斥的。 可能为 null；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getNetIFAddrs</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getNetIFStats" tabindex="-1">getNetIFStats() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getNetIFStats" aria-label="Permalink to &quot;getNetIFStats() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getNetIFStats}&quot;">​</a></h2><p>获取系统网络接口状态信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;">网络接口列表</td></tr></tbody></table><p>网络接口当前状态信息列表，元素包括以下属性：</p><ul><li>isup: 是否已启用；</li><li>duplex: 双工通信类型；</li><li>speed: 以兆位 (MB) 表示的 NIC 速度，如果无法确定（例如“本地主机”），则为 0；</li><li>mtu: NIC 的最大传输单位，以字节为单位；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getNetIFStats</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h1 id="getSensorsTemperatures" tabindex="-1">getSensorsTemperatures(fahrenheit) <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getSensorsTemperatures" aria-label="Permalink to &quot;getSensorsTemperatures(fahrenheit) &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getSensorsTemperatures}&quot;">​</a></h1><p>获取温度传感器数据</p><table tabindex="0"><thead><tr><th style="text-align:left;">参数</th><th style="text-align:left;">类型</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">fahrenheit</td><td style="text-align:left;">boolean</td><td style="text-align:left;">是否使用华氏度，默认为 false</td></tr></tbody></table><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;"></td></tr></tbody></table><p>返回温度传感器数据列表，如果硬件或操作系统不支持，则返回空列表。当前仅支持 Linux, FreeBSD。 元素包含以下属性：</p><ul><li>label: 传感器名称</li><li>current: 当前温度</li><li>high: 最高温度</li><li>critical: 警告温度</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getSensorsTemperatures</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h1 id="getSensorsFans" tabindex="-1">getSensorsFans() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getSensorsFans" aria-label="Permalink to &quot;getSensorsFans() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getSensorsFans}&quot;">​</a></h1><p>获取风扇转速数据</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;"></td></tr></tbody></table><p>返回风扇转速数据列表，如果硬件或操作系统不支持，则返回空列表（当前支持 Linux, FreeBSD）。 元素包含以下属性：</p><ul><li>label: 风扇名称</li><li>current: 当前转速（RPM，即 每分钟转数）；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getSensorsFans</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h1 id="getSensorsBattery" tabindex="-1">getSensorsBattery() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getSensorsBattery" aria-label="Permalink to &quot;getSensorsBattery() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getSensorsBattery}&quot;">​</a></h1><p>获取电池信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">object</td><td style="text-align:left;"></td></tr></tbody></table><p>返回获取电池信息数据，如果硬件或操作系统不支持，则返回空数据，（当前支持 Linux, FreeBSD，Windows， MacOS）包含以下属性：</p><ul><li>percent: 电池电量剩余百分比；</li><li>secsleft: 电池电量耗尽前还剩多少秒的粗略近似值；</li><li>power_plugged: 是否连接了交流电源线，无法确定则为 null；</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getSensorsBattery</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h1 id="getBootTime" tabindex="-1">getBootTime() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getBootTime" aria-label="Permalink to &quot;getBootTime() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getBootTime}&quot;">​</a></h1><p>获取系统已启动时间</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">number</td><td style="text-align:left;"></td></tr></tbody></table><p>返回自纪元(epoch)以来以秒表示的系统启动时间，在 Windows 上，如果它在不同的进程中使用，这个函数可能会返回一个减少(off by) 1 秒的时间。</p><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getBootTime</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div><h2 id="getUsers" tabindex="-1">getUsers() <span class="VPBadge tip"><!--[-->Since 25.3.5.1<!--]--></span> <a class="header-anchor" href="#getUsers" aria-label="Permalink to &quot;getUsers() &lt;Badge type=&quot;tip&quot; text=&quot;Since 25.3.5.1&quot; /&gt; {#getUsers}&quot;">​</a></h2><p>获取已连接到系统的用户信息</p><table tabindex="0"><thead><tr><th style="text-align:left;">返回值</th><th style="text-align:left;">说明</th></tr></thead><tbody><tr><td style="text-align:left;">list[object]</td><td style="text-align:left;">用户信息列表</td></tr></tbody></table><p>返回当前已连接到系统的用户信息，包括以下字段：</p><ul><li>name: 用户名.</li><li>terminal: 与用户关联的 tty 或 伪tty ，如果有，否则为 None 。</li><li>host: 与条目关联的主机名（如果有）。</li><li>started: 创建时间作为一个浮点数，以自纪元（epoch）以来的秒数表示。</li><li>pid: 登录进程的 pid（如 sshd、tmux、gdm-session-worker 等）。 在 Windows 和 OpenBSD 上，pid 始终为 null 。</li></ul><div class="language-javascript vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">javascript</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> __A.device.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">getUsers</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">();</span></span></code></pre></div></div></div></main><footer class="VPDocFooter" data-v-e6f2a212 data-v-1bcd8184><!--[--><!--]--><div class="edit-info" data-v-1bcd8184><!----><div class="last-updated" data-v-1bcd8184><p class="VPLastUpdated" data-v-1bcd8184 data-v-1bb0c8a8>最后更新于: <time datetime="2025-03-14T05:20:52.000Z" data-v-1bb0c8a8></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-1bcd8184><span class="visually-hidden" id="doc-footer-aria-label" data-v-1bcd8184>Pager</span><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link prev" href="/pyChariot/jsapi_core.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>上一页</span><span class="title" data-v-1bcd8184>基础功能　　core</span><!--]--></a></div><div class="pager" data-v-1bcd8184><a class="VPLink link pager-link next" href="/pyChariot/jsapi_dialog.html" data-v-1bcd8184><!--[--><span class="desc" data-v-1bcd8184>下一页</span><span class="title" data-v-1bcd8184>对话框　　　dialog</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-d8b57b2d data-v-566314d4><div class="container" data-v-566314d4><p class="message" data-v-566314d4>基于 MIT 许可发布</p><p class="copyright" data-v-566314d4>版权所有 © 2025-2025, pyChariot, Chanix@GitHub</p></div></footer><!--[--><!--]--></div></div>
    <script>window.__VP_HASH_MAP__=JSON.parse("{\"args.md\":\"FJGQu4Km\",\"changelog.md\":\"B86JHMQ5\",\"debugging.md\":\"C7AkUUUO\",\"dir-appchips.md\":\"JB2ztNFs\",\"dir-data.md\":\"SbzpJA4M\",\"dir-temp.md\":\"JKMr_gq6\",\"dir-wvdata.md\":\"DCdjLo5f\",\"dirs-and-files.md\":\"CSFhdXnc\",\"events.md\":\"qXT4jJyA\",\"examples-deepseek.md\":\"Cdkt3r0Z\",\"getting-started.md\":\"B1TRmPOp\",\"hotkey.md\":\"JzsbM16M\",\"index.md\":\"B0F_d36A\",\"jsapi.md\":\"Cw16TPfm\",\"jsapi_appchip.md\":\"D84xPZTW\",\"jsapi_clipboard.md\":\"BR89esCG\",\"jsapi_core.md\":\"BOh81AVf\",\"jsapi_device.md\":\"DbRW_pEV\",\"jsapi_dialog.md\":\"IBMFu8Ap\",\"jsapi_env.md\":\"DWQVwcga\",\"jsapi_fsys.md\":\"oIUNyR1L\",\"jsapi_hotkey.md\":\"CIsWPCUE\",\"jsapi_mainwin.md\":\"CrqOJTyr\",\"jsapi_memdb.md\":\"Bz_o_NDY\",\"jsapi_process.md\":\"LTDdvsV2\",\"jsapi_python.md\":\"PHdCt0oG\",\"readme.md\":\"B9-riMEp\",\"what-is-pychariot.md\":\"D9F8FQ9q\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"pyChariot\",\"description\":\"pyChariot, 跨平台桌面应用开发工具。\",\"base\":\"/pyChariot/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"langMenuLabel\":\"多语言\",\"returnToTopLabel\":\"回到顶部\",\"sidebarMenuLabel\":\"菜单\",\"darkModeSwitchLabel\":\"主题\",\"lightModeSwitchTitle\":\"切换到浅色模式\",\"darkModeSwitchTitle\":\"切换到深色模式\",\"skipToContentLabel\":\"跳转到内容\",\"nav\":[{\"text\":\"回首页\",\"link\":\"/\"},{\"text\":\"更新日志\",\"link\":\"/changelog\"},{\"text\":\"立即下载\",\"link\":\"https://github.com/Chanix/pyChariot/releases\"},{\"text\":\"讨论组\",\"link\":\"https://github.com/Chanix/pyChariot/discussions\"}],\"docFooter\":{\"prev\":\"上一页\",\"next\":\"下一页\"},\"footer\":{\"message\":\"基于 MIT 许可发布\",\"copyright\":\"版权所有 © 2025-2025, pyChariot, Chanix@GitHub\"},\"outline\":{\"label\":\"本页导航\"},\"lastUpdated\":{\"text\":\"最后更新于\",\"formatOptions\":{\"dateStyle\":\"short\",\"timeStyle\":\"medium\"}},\"sidebar\":[{\"text\":\"pyChariot 简介\",\"collapsed\":false,\"items\":[{\"text\":\"pyChariot 是什么\",\"link\":\"/what-is-pychariot\"},{\"text\":\"快速开始\",\"link\":\"/getting-started\"}]},{\"text\":\"开发示例\",\"collapsed\":false,\"items\":[{\"text\":\"示例：DeepSeek\",\"link\":\"/examples-deepseek\"}]},{\"text\":\"开发者指南\",\"collapsed\":false,\"items\":[{\"text\":\"命令行参数\",\"link\":\"/args\"},{\"text\":\"文件与目录结构\",\"link\":\"/dirs-and-files\"},{\"items\":[{\"text\":\"appchips\",\"link\":\"/dir-appchips\"},{\"text\":\"data\",\"link\":\"/dir-data\"},{\"text\":\"temp\",\"link\":\"/dir-temp\"},{\"text\":\"wvdata\",\"link\":\"/dir-wvdata\"}]}]},{\"text\":\"JS 扩展与 API\",\"collapsed\":false,\"items\":[{\"text\":\"扩展对象概述\",\"link\":\"/jsapi\"},{\"items\":[{\"text\":\"小应用　　　appchip\",\"link\":\"/jsapi_appchip\"},{\"text\":\"剪贴板　　　clipboard\",\"link\":\"/jsapi_clipboard\"},{\"text\":\"基础功能　　core\",\"link\":\"/jsapi_core\"},{\"text\":\"设备信息　　device\",\"link\":\"/jsapi_device\"},{\"text\":\"对话框　　　dialog\",\"link\":\"/jsapi_dialog\"},{\"text\":\"环境变量　　env\",\"link\":\"/jsapi_env\"},{\"text\":\"文件系统　　fsys\",\"link\":\"/jsapi_fsys\"},{\"text\":\"全局热键　　hotkey\",\"link\":\"/jsapi_hotkey\"},{\"text\":\"主窗口　　　mainwin\",\"link\":\"/jsapi_mainwin\"},{\"text\":\"内存数据库　memdb\",\"link\":\"/jsapi_memdb\"},{\"text\":\"进程管理　　process\",\"link\":\"/jsapi_process\"},{\"text\":\"python&nbsp;&nbsp;　　python\",\"link\":\"/jsapi_python\"}]}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://Chanix.github.io/\"}]},\"locales\":{\"root\":{\"label\":\"简体中文\",\"lang\":\"zh\"}},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
    
  </body>
</html>